查看原文
其他

【第1733期】Element-UI 技术揭秘 — Container布局容器组件的设计与实现

黄轶黄老师 前端早读课 2019-10-31

前言

Element-UI 技术揭秘 系列第三篇来了。文末有直播福利,有兴趣的童鞋可以关注下。今日早读文章由Zoom架构师@黄轶授权分享。

公众号后台回复关键词 黄轶 查看专栏内容

正文从这开始~~

【第1721期】Element-UI 技术揭秘 — Layout布局组件的设计与实现,我们分析了 Layout 布局组件的设计和实现,它的应用场景通常是局部布局。对于整个页面的布局,element-ui 提供了 Container 布局容器组件,专门用于 PC 管理后台页面的整体布局。

需求分析

我们先通过几幅图看一下页面的常见布局。

这两张图的布局在后台系统中很常见,通过简单的 CSS 就可以实现。不过我们更喜欢用组件化的开发方式,把这些 CSS 的细节封装到组件里,如下:

  1. <el-container>

  2. <el-header>Header</el-header>

  3. <el-main>Main</el-main>

  4. <el-footer>Footer</el-footer>

  5. </el-container>


  6. <el-container>

  7. <el-header>Header</el-header>

  8. <el-container>

  9. <el-aside width="200px">Aside</el-aside>

  10. <el-container>

  11. <el-main>Main</el-main>

  12. <el-footer>Footer</el-footer>

  13. </el-container>

  14. </el-container>

  15. </el-container>

我们使用了 <el-container><el-header><el-main><el-footer><el-aside> 5 种组件,来看一下它们各自的作用:

<el-container>:外层容器。当子元素中包含 <el-header><el-footer> 时,全部子元素会垂直上下排列,否则会水平左右排列。

<el-header>:顶栏容器。<el-aside>:侧边栏容器。<el-main>:主要区域容器。<el-footer>:底栏容器。

这几个组件需要遵循如下约束:

<el-container> 的子元素只能是后四者,后四者的父元素也只能是 <el-container>

了解了 element-ui Container 布局容器组件的需求后,我们来分析它的设计和实现。

设计和实现

针对图示的布局,我们可以通过 flex 的布局方式轻松实现,element-ui 也是基于 flex 布局实现的,接下来我们来分析各个组件的实现。

ElContainer 组件

先来看模板部分:

  1. <template>

  2. <section class="el-container">

  3. <slot></slot>

  4. </section>

  5. </template>

<el-container> 组件会渲染成一个 <section> 标签,并通过 slot 做内容分发。

再来看一下 CSS 部分:

  1. @include b(container) {

  2. display: flex;

  3. flex-direction: row;

  4. flex: 1;

  5. flex-basis: auto;

  6. box-sizing: border-box;

  7. min-width: 0;

  8. }

重点看一下 CSS 部分,display:flex 创建了一个 flex 容器,flex-direction:row 指定了内部元素是在水平方向排列。这里为什么还有 flex:1 呢,因为 <el-container> 容器是支持嵌套的,并且我们知道 flex:1 相当于 flex-grow:1;flex-shrink:1;flex-basis:0,也就是当 <el-container> 被嵌套的时候,它会占满剩余空间。flex-basis:auto 表示分配空间之前会先跟父容器预约自身内容大小的空间,然后剩下的才会归入到剩余空间。

<el-container> 容器默认是水平排列,当然也需要支持垂直排列,我们可以给组件提供一个 direction 的 prop,如果传入的 direction 是 vertical,添加对应的 CSS。

  1. <template>

  2. <section class="el-container" :class="{ 'is-vertical': isVertical }">

  3. <slot></slot>

  4. </section>

  5. </template>

  1. export default {

  2. name: 'ElContainer',


  3. componentName: 'ElContainer',


  4. props: {

  5. direction: String

  6. },


  7. computed: {

  8. isVertical() {

  9. if (this.direction === 'vertical') {

  10. return true;

  11. } else if (this.direction === 'horizontal') {

  12. return false;

  13. }

  14. }

  15. }

  16. };

  1. @include when(vertical) {

  2. flex-direction: column;

  3. }

如果传入的 direction 为 vertical,则添加 is-vertical 的 CSS,最终通过修改 flex-direction:column 实现内部元素是在垂直方向排列。

回顾前面的一个需求:当 <el-container> 容器的子元素中包含 <el-header><el-footer> 时,全部子元素会垂直上下排列,否则会水平左右排列。

实现它也很容易,扩展计算属性 isVertical 的判断条件即可:

  1. computed: {

  2. isVertical() {

  3. if (this.direction === 'vertical') {

  4. return true;

  5. } else if (this.direction === 'horizontal') {

  6. return false;

  7. }

  8. return this.$slots && this.$slots.default

  9. ? this.$slots.default.some(vnode => {

  10. const tag = vnode.componentOptions && vnode.componentOptions.tag;

  11. return tag === 'el-header' || tag === 'el-footer';

  12. })

  13. : false;

  14. }

  15. }

这里用了一个小技巧,this.$slots.default 获取的是默认插槽中的所有 vnodes 节点,然后对他们遍历,通过 vnode.componentOptions.tag 来判断这个 vnode 是不是 <el-header> 或者是 <el-footer>。vnode.componentOptions 并不在官网 API 里,但是对于熟读 Vue 源码的人来说并不陌生。

ElHeader 组件

先来看一下模板部分:

  1. <template>

  2. <header class="el-header">

  3. <slot></slot>

  4. </header>

  5. </template>

<el-header> 组件会渲染成一个 <header> 标签,并通过 slot 做内容分发。

再来看一下 CSS 部分:

  1. @include b(header) {

  2. padding: $--header-padding;

  3. box-sizing: border-box;

  4. flex-shrink: 0;

  5. }

其中 $--header-padding 是一个变量,在 packages/theme-chalk/src/common/var.scss 文件中定义。flex-shrink: 0 表示即使空间不够,也不会缩小 <el-header> 所占空间。

通常来说头部都会有一个固定高度,因此 <el-header> 允许你传入一个 height 的 props 来指定高度,如果不指定的话提供一个默认高度。

  1. <template>

  2. <header class="el-header" :style="{ height }">

  3. <slot></slot>

  4. </header>

  5. </template>

  1. export default {

  2. name: 'ElHeader',


  3. componentName: 'ElHeader',


  4. props: {

  5. height: {

  6. type: String,

  7. default: '60px'

  8. }

  9. }

  10. };

由于直接通过 :style 设置的样式,所以这里传入高度的时候一定要携带单位。

ElMain 组件

先来看一下模板部分:

  1. <template>

  2. <main class="el-main">

  3. <slot></slot>

  4. </main>

  5. </template>

<el-main> 组件会渲染成一个 <main>标签,并通过 slot 做内容分发。

再来看一下 CSS 部分:

  1. @include b(main) {

  2. // IE11 supports the <main> element partially https://caniuse.com/#search=main

  3. display: block;

  4. flex: 1;

  5. flex-basis: auto;

  6. overflow: auto;

  7. box-sizing: border-box;

  8. padding: $--main-padding;

  9. }

注意, <main> 标签在 IE11 中是部分支持的。通常 <main> 中包裹的内容完全由它的子元素来决定,所以并不会设置高和宽,只是通过 flex:1 来分配 <el-container> 容器的剩余空间。

ElFooter 组件

先来看一下模板部分:

  1. <template>

  2. <footer class="el-footer">

  3. <slot></slot>

  4. </footer>

  5. </template>

<el-footer> 组件会渲染成一个 <footer> 标签,并通过 slot 做内容分发。

再来看一下 CSS 部分:

  1. @include b(footer) {

  2. padding: $--footer-padding;

  3. box-sizing: border-box;

  4. flex-shrink: 0;

  5. }

和头部一样,通常底部也会有一个固定高度,因此 <el-footer> 允许你传入一个 height 的 props 来指定高度,如果不指定的话提供一个默认高度。

  1. <template>

  2. <footer class="el-footer" :style="{ height }">

  3. <slot></slot>

  4. </footer>

  5. </template>

  1. export default {

  2. name: 'ElFooter',


  3. componentName: 'ElFooter',


  4. props: {

  5. height: {

  6. type: String,

  7. default: '60px'

  8. }

  9. }

  10. };

ElAside 组件

先来看一下模板部分:

  1. <template>

  2. <aside class="el-aside">

  3. <slot></slot>

  4. </aside>

  5. </template>

<el-aside> 组件会渲染成一个 <aside> 标签,并通过 slot 做内容分发。

再来看一下 CSS 部分:

  1. @include b(aside) {

  2. overflow: auto;

  3. box-sizing: border-box;

  4. flex-shrink: 0;

  5. }

<el-aside> 组件用来渲染侧边栏,而侧边栏通常会有宽度,因此 <el-aside>,允许你传入一个 width 的 props 来指定宽度,如果不指定的话提供一个默认宽度。

  1. <template>

  2. <aside class="el-aside" :style="{ width }">

  3. <slot></slot>

  4. </aside>

  5. </template>

  1. export default {

  2. name: 'ElAside',


  3. componentName: 'ElAside',


  4. props: {

  5. width: {

  6. type: String,

  7. default: '300px'

  8. }

  9. }

  10. };

总结

element-ui 的 Container 布局容器组件的实现还是很简单的:创建了一些语义化的标签,利用插槽做内容分发,通过 flex 实现布局效果。

学习完这篇文章,你可以顺便对 flex 布局、HTML5 的语义化标签做一下复习,加深理解,并了解到 Vue 源码中的一些小技巧。

关于本文 作者:@黄轶 原文:https://mp.weixin.qq.com/s/HYaKDZR-gAomkJJBOGHghQ

为你推荐

【第1452期】见微知著,Google Photos Web UI 完善之旅

【第1338期】利用StoryBook开发UI组件管理

在线直播

由图灵直播联合@黄轶在2019年9月26号(今晚)做一场关于《Web前端求职之路》在线直播课,有兴趣的童鞋可以通过文末左下角“阅读原文”报名参与(需提前下载钉钉)。

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存